package top.lixunda.ecommerce.server.good.api.controller;

import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;
import top.lixunda.commerce.common.core.entity.MessageObject;
import top.lixunda.ecommerce.server.good.api.entity.db.QiNiuFileDO;

import javax.servlet.http.HttpServletRequest;
import java.util.List;

/**
 * 七牛云上传文件信息管理，本操作基本上为内部操作，需要鉴权
 *
 * @author Xumda
 * @version time:2020/1/19 9:38
 */
@SuppressWarnings("unused")
@Api("七牛云上传文件信息管理，本操作基本上为内部操作，需要鉴权")
@RequestMapping("/qi_niu_file")
public interface IQiNiuFileController {

    /**
     * 根据id查询信息
     *
     * @param id id
     * @return 文件信息
     */
    @ApiOperation("根据id查询信息")
    @GetMapping("queryById")
    MessageObject<QiNiuFileDO> queryById(@RequestParam("id") Integer id);

    /**
     * 根据多个id查询信息
     *
     * @param ids id列表
     * @return 文件信息列表
     */
    @ApiOperation("根据多个id查询信息")
    @PostMapping("queryByIds")
    MessageObject<List<QiNiuFileDO>> queryByIds(@RequestBody List<Integer> ids);

    /**
     * 根据id下载文件
     *
     * @param id      id
     * @param request HttpServletRequest
     * @return ResponseEntity
     */
    @ApiOperation("根据id下载文件")
    @GetMapping("downloadAsFileById")
    ResponseEntity<byte[]> downloadAsFileById(@RequestParam("id") Integer id, HttpServletRequest request);

    /**
     * 根据id下载文件
     *
     * @param url     文件网络地址
     * @param request HttpServletRequest
     * @return ResponseEntity
     */
    @ApiOperation("根据id下载文件")
    @GetMapping("downloadAsFileByUrl")
    ResponseEntity<byte[]> downloadAsFileByUrl(@RequestParam("url") String url, HttpServletRequest request);

}
